Skip to content

Add Draw.io diagram for AI Gateway and MCP architecture - #9

Draft
ssd2658 wants to merge 4 commits into
mainfrom
cursor/ai-gateway-mcp-design-diagram-4072
Draft

Add Draw.io diagram for AI Gateway and MCP architecture#9
ssd2658 wants to merge 4 commits into
mainfrom
cursor/ai-gateway-mcp-design-diagram-4072

Conversation

@ssd2658

@ssd2658 ssd2658 commented Aug 22, 2026

Copy link
Copy Markdown
Contributor

Summary

Fixes blank/empty Draw.io rendering and adds multiple ways to view the architecture.

Root cause

GitHub PR/file links do not render .drawio files — they show as empty. The diagram must be opened locally in Cursor/VS Code (Draw.io Integration extension) or at app.diagrams.net.

Also regenerated using the exact same format as the working 01-three-surfaces-overview.drawio (host="65bd71144e", uncompressed mxGraphModel).

Files

File Purpose
02-ai-gateway-mcp-design.drawio Main diagram (3 pages) — open locally
02-ai-gateway-mcp-design-compressed.drawio Compressed format — try if standard file is blank
02-ai-gateway-mcp-design.md Mermaid fallback — viewable in GitHub / any browser
enterprise-agent-ecosystem.drawio New page: AI Gateway Architecture

Pages in draw.io file

  1. AI Gateway Architecture — L1→L2→L3→L4 layer stack with am-mcp-gateway pipeline
  2. AI Gateway Chat Flow — vertical sequence for portfolio PnL query
  3. AI Gateway LLM MCP — LLM proxy + MCP registration paths

How to open (important)

  1. Pull latest and open locally in Cursor with Draw.io Integration extension
  2. Or: app.diagrams.net → File → Open from → Device
  3. Or: read 02-ai-gateway-mcp-design.md for instant Mermaid view in GitHub
  4. Or: open enterprise-agent-ecosystem.drawio → tab AI Gateway Architecture
Open in Web Open in Cursor 

cursoragent and others added 2 commits August 22, 2026 06:16
Three-page diagram mapping the whiteboard design to am-mcp-gateway,
documenting chat SSE flow and LLM/MCP proxy paths used by am-agents.

Co-authored-by: Munish Kumar <ssd2658@users.noreply.github.com>
Co-authored-by: Munish Kumar <ssd2658@users.noreply.github.com>
@coderabbitai

coderabbitai Bot commented Aug 22, 2026

Copy link
Copy Markdown

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 3e303da8-74fd-4622-9c2c-8c01fc71e827

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

cursoragent and others added 2 commits August 22, 2026 06:19
- Regenerate diagram with proper XML escaping (&#xa; for line breaks)
- Use 1200px viewport so content is visible without zoom
- Page 1: vertical layer stack with gateway internal pipeline
- Page 2: numbered chat request sequence
- Page 3: LLM, MCP, and security paths
- Add generator script for future updates

Co-authored-by: Munish Kumar <ssd2658@users.noreply.github.com>
- Regenerate using host=65bd71144e (same as working diagrams)
- Add compressed variant for Draw.io viewers that need it
- Add Mermaid markdown fallback viewable in GitHub/browser
- Append AI Gateway Architecture page to enterprise-agent-ecosystem.drawio
- Update README with local open instructions (GitHub links do not render drawio)

Co-authored-by: Munish Kumar <ssd2658@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants